/*
 * Copyright (c) 2003-2010, Live Media Pty. Ltd.
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without modification, are permitted
 * provided that the following conditions are met:
 *
 *  1. Redistributions of source code must retain the above copyright notice, this list of
 *     conditions and the following disclaimer.
 *  2. Redistributions in binary form must reproduce the above copyright notice, this list of
 *     conditions and the following disclaimer in the documentation and/or other materials
 *     provided with the distribution.
 *  3. Neither the name of Live Media nor the names of its contributors may be used to endorse
 *     or promote products derived from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
 * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER
 * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

package com.argot.contiki;

import com.colony.remote.RemoteException;


/**
 * The ITest class represents a set of interfaces from a remote host.
 * This interface attempts to demonstrate the various combinations of
 * calling remote interfaces.
 * 
 * @author davidryan
 *
 */
public interface ITest
{
	public static final String TYPENAME = "test";
	
	/*
	 * Simple method with basic input and return values.
	 */
	public int doSomething( int x );
	
	/*
	 * Method not declared in interface dictionary.
	 */
	public int invalidMethod( int x ) throws RemoteException;
	
	/*
	 * Generic remote exception
	 */
	public int methodWithException( int x ) throws RemoteException;
	
	/*
	 * Undeclared runtime exception.
	 */
	public void methodUndeclaredException();
	
	/*
	 * Custom exceptions.
	 */
	public void methodCustomException() throws TestException, RemoteException;
	
	/*
	 * Method without a return value.
	 */
	public void methodNoReturn( int x );
	
	/*
	 * Method with no parameters.
	 */
	public void methodNoParam();
	
	/*
	 * Method with complex parameters.
	 */
	public void methodComplexParam( TestValue value );
	
	/*
	 * Method with complex return values.
	 */
	public TestValue methodComplexReturn( int x );
	
}
